<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<META name="generator" content="HTML Tidy for Linux/x86 (vers 12 April 2005), see www.w3.org">
<TITLE>Declaring a new host</TITLE>
<META name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.79">
<LINK rel="HOME" title="Abyss Web Server For Windows User's Guide" href="index.html">
<LINK rel="UP" title="Hosts Management" href="hosts.html">
<LINK rel="PREVIOUS" title="Hosts Management" href="hosts.html">
<LINK rel="NEXT" title="Configuring a host" href="hosts-configuration.html">
<LINK rel="STYLESHEET" type="text/css" href="stylesheet.css">
<META name="AppleIcon" content="icon.png">
<META name="AppleTitle" content="Declaring a new host">
<META name="Description" content="Declaring a new host">
<META name="AppleOrder" content="">
</HEAD>
<BODY class="SECT1" bgcolor="#FFFFFF" text="#000000">
<DIV class="NAVHEADER">
<TABLE summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<TR>
<TH colspan="3" align="center">Abyss Web Server For Windows User's Guide</TH>
</TR>
<TR>
<TD width="10%" align="left" valign="bottom"><A href="hosts.html" accesskey="P">Prev</A></TD>
<TD width="80%" align="center" valign="bottom">Chapter 5. Hosts Management</TD>
<TD width="10%" align="right" valign="bottom"><A href="hosts-configuration.html" accesskey="N">Next</A></TD>
</TR>
</TABLE>
<HR align="left" width="100%"></DIV>
<DIV class="SECT1">
<H1 class="SECT1"><A name="HOSTS-ADD" id="HOSTS-ADD">Declaring a new host</A></H1>
<P>To add a new host to the web server, go to the main console dialog and press <B class="GUILABEL">Add</B> in the <B class="GUILABEL">Hosts</B> table.</P>
<P>The displayed dialog contains the following fields:</P>
<UL>
<LI>
<P><A name="HOSTS-ADD-PROTOCOL" id="HOSTS-ADD-PROTOCOL"></A> <B class="GUILABEL">Protocol</B>: Set it to <B class="GUILABEL">HTTP</B> if the host will use normal non-secure connections. If you want to have the host serve content over secure connections only using SSL/TLS, set it to <B class="GUILABEL">HTTPS</B>. If you are on Abyss Web Server X2, you can also choose to have the host serve content on both secure and non-secure connections by setting <B class="GUILABEL">Protocol</B> to <B class="GUILABEL">HTTP+HTTPS</B>. In such a situation, you can configure some virtual paths to be accessible on secure connections only by adding them to the <B class="GUILABEL">Exclusively Serve On HTTPS</B> table.</P>
</LI>
<LI>
<P><A name="HOSTS-ADD-PROTOCOL-0PANE-PORT" id="HOSTS-ADD-PROTOCOL-0PANE-PORT"></A> <A name="HOSTS-ADD-PROTOCOL-2PANE-PORT" id="HOSTS-ADD-PROTOCOL-2PANE-PORT"></A> <B class="GUILABEL">HTTP Port</B>: The port on which the new host will wait for HTTP connections. Its default value is 80. This field is not available if the <B class="GUILABEL">Protocol</B> is set to <B class="GUILABEL">HTTPS</B> only.</P>
</LI>
<LI>
<P><A name="HOSTS-ADD-PROTOCOL-1PANE-SECUREPORT" id="HOSTS-ADD-PROTOCOL-1PANE-SECUREPORT"></A> <A name="HOSTS-ADD-PROTOCOL-2-PANE-SECUREPORT" id="HOSTS-ADD-PROTOCOL-2-PANE-SECUREPORT"></A> <B class="GUILABEL">HTTPS Port</B>: The port on which the new host will wait for secure HTTPS connections. Its default value is 443. This field is not available if the <B class="GUILABEL">Protocol</B> is set to <B class="GUILABEL">HTTP</B> only.</P>
</LI>
<LI>
<P><A name="HOSTS-ADD-PROTOCOL-1PANE-CERTIFICATE" id="HOSTS-ADD-PROTOCOL-1PANE-CERTIFICATE"></A> <A name="HOSTS-ADD-PROTOCOL-2PANE-CERTIFICATE" id="HOSTS-ADD-PROTOCOL-2PANE-CERTIFICATE"></A> <B class="GUILABEL">Certificate</B>: The certificate that will be used for secure connections with the new host. This field is not available if the <B class="GUILABEL">Protocol</B> is set to <B class="GUILABEL">HTTP</B> only. Note that the certificate's <B class="GUILABEL">Host Name (Common Name)</B> should be equal to or match with the names of the new host that you are declaring. Otherwise, visitors' browsers will report a warning about mismatched names on every access to the host.</P>
</LI>
<LI>
<P><A name="HOSTS-ADD-NAME" id="HOSTS-ADD-NAME"></A> <B class="GUILABEL">Host Name</B>: The main name of the new host. If the field is empty, the host will not be associated with any name and will answer to all requests that reach it on the configured port. The host can also have more than one name: additional names should be declared later in the <B class="GUILABEL">Host Names</B> table in the <B class="GUILABEL">General</B> dialog related to the host. The host name can also be a pattern such as <KBD class="USERINPUT">*.mysite.com</KBD>. Refer to the "<A href="patternsformat.html">Patterns Format</A>" appendix for more information about patterns.</P>
</LI>
<LI>
<P><A name="HOSTS-ADD-PATH" id="HOSTS-ADD-PATH"></A> <B class="GUILABEL">Documents Path</B>: The path of the web site files. If it is a relative path then it is considered as a subpath of the server root.</P>
</LI>
<LI>
<P><A name="HOSTS-ADD-LOG" id="HOSTS-ADD-LOG"></A> <B class="GUILABEL">Log File</B>: The path of the log file. If it is relative, it is considered as a subpath of the server root. If empty, logging is disabled.</P>
</LI>
<LI>
<P><A name="HOSTS-ADD-TEMPLATE" id="HOSTS-ADD-TEMPLATE"></A> <B class="GUILABEL">Copy Configuration From</B>: The configuration of the new host is cloned from the configuration of already defined hosts or from the default configuration.</P>
</LI>
</UL>
<DIV class="NOTE">
<BLOCKQUOTE class="NOTE">
<P><B>Note:</B> Adding a new host is only possible in Abyss Web Server X2. Abyss Web Server X1 can only manage a single host.</P>
</BLOCKQUOTE>
</DIV>
</DIV>
<DIV class="NAVFOOTER">
<HR align="left" width="100%">
<TABLE summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<TR>
<TD width="33%" align="left" valign="top"><A href="hosts.html" accesskey="P">Prev</A></TD>
<TD width="34%" align="center" valign="top"><A href="index.html" accesskey="H">Home</A></TD>
<TD width="33%" align="right" valign="top"><A href="hosts-configuration.html" accesskey="N">Next</A></TD>
</TR>
<TR>
<TD width="33%" align="left" valign="top">Hosts Management</TD>
<TD width="34%" align="center" valign="top"><A href="hosts.html" accesskey="U">Up</A></TD>
<TD width="33%" align="right" valign="top">Configuring a host</TD>
</TR>
</TABLE>
</DIV>
<DIV class="COPYRIGHT">Copyright &copy; 2001-2009 Aprelium</DIV>
</BODY>
</HTML>
